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INTRODUCTION 

This document describes the internal structure of Apple Computer's Lisa Phrase files. 
Phrase files contain all the textual information that the Lisa Office System tools 
display to the user. This information consists of menu titles, alert messages and button 
titles, and Desktop icon names. Phrase files are generated using an Apple program that 
runs within the Lisa Development environment, the Workshop. This program converts a 
Text file containing various phrases into a compact phrase file. A sample phrase file is 
completely documented using both a listing of the raw hexadecimal values within the 
file and the Text (i.e., human readable) version of the same file. 


This document can be of some use to those people who wish to understand the Lisa‘s 
operation better and/or who wish to use this information within programs that they 
develop for other machines. For example, the Lisa Office System tools contain many 
clearly—written phrases whose wording can be used or imitated in newer programs. 


NOTE 
The information contained within this document was obtained by a 
careful analysis of many phrase files. Since the author is in no 
way associated with Apple Computer this information may be in 
error. Where discrepancies exist their nature and location are 
clearly noted. 


PHRASE FILE DISASSEMBLER 

To better understand phrase files | wrote a Workshop program in Lisa Pascal titled 
PhraseDisasm that disassembles the contents of phrase files into a readable Text file. 
This program generated both the raw hexadecimal listing and the Text listing contained 
within this document. This program can handle both older and newer phrase files from 
the Lisa Office System. 


INTERNAL STRUCTURE 

Phrase files are composed of textual phrases arranged in a compact format. This 
format is divisible into several sequentual sections with each section containing specific 
phrase—related information. Each section is illustrated with structure diagrams that 
describe the exact layout of the section's data. These diagrams contain a description of 
the data and its size in bytes. Sizes denoted by “?" mean their sizes vary. Strings 
contain a length byte followed by the actual character data for the string. Descriptions 
followed by “(???)" are not fully understood and need future clarification (if possible). 
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The sections of a phrase file are as follows: 


. Menu Phrase Section 

. Miscellaneous Section 1 

. Miscellaneous Section 2 

. Icon Phrase Section 

. Alert Button Phrase Section 

. Alert Phrase Information Section 
. Alert Phrase Section 


1. Menu Phrase Section 

This section contains the menu phrases for a tool. The first integer (2 bytes) in the 
phrase file contains a count of the number of menu subsections present in this section. 
Each subsection contains the data for a complete pull-down menu. The subsection 
structure follows: 


Hen ID SSSCSCSCSCSCSCSCSCSCiYSC 
[Hen enable flags SSCS 
rHenu length (in bytes) SCS 2 
FHenu iten #1 keyboard comand (620 none) | 1] 
[Hens iten #1 flags or type style 7%) «dt 2 
Eee ee ee 
[Henu item #N keyboard comand (#20 = none) | 1] 
FHenu item #N flags or type style 727) _—~+dt 2 | 


Sometimes this section is not present in a phrase file. For example, phrase file 
“System.DW.Phrase", the phrases for the Daisy Wheel printer, does not have a menu 
section. To test whether the menu section exists test if the menu count integer is 
greater than 31. if this is true, then this section does not exist. If the menu count is 
less than or equal to 31, then test the second file integer (31 is a special number here 
since the maximum number of menus that the Lisa Menu Manager can handle is 31. 
Thus, ! didn't pick this value randomly!). If this integer (usually holds the menu ID value) 
is greater than 255 (a random value that | chose since it is fairly large and no menu ID 
should be this large), then the menu section does not exist. For example, the phrase file 
titled “InstallPhrase” from the Lisa—to—Macintosh Migration Kit disk # 1 contained 
the following integers: $0001 and $013F. In this case | ignored the $0001 value (I'm 
not certain what it means) and disassembied the data as the Icon Phrase Section. 


2. Miscellaneous Section 1 

This section contains a table of records each with 2 integers (4 bytes). If the first 
integer in this section equals zero ($0000), then this section does not exist and the zero 
integer can be viewed as a menu ID that terminates the Menu Phrase Section. If the 
first integer equals a non—zero value, then the value is the count of the number of 
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records in this section. I’m not certain what this section data defines, but | believe it to 
be a remnant from an older phrase file. This table has only been found in the Scrapbook 
tool and the Lisa—to—Macintosh tool. | believe this section is also present in the older 
Office System 2.0 tools, but since | have not looked at phrase files from this version | 
cannot be 100% certain. 


3. Miscellaneous Section 2 
This section contains 3 integers (6 bytes) whose values are currently meaningless. | 
believe they deat with the heap space needed by the phrase file. 


4. Icon Phrase Section 

This section contains a list of the 5 titles needed by the alert box icons. These title 
strings correspond to the “?", “Wait", “Stop”, “Note”, and “Caution” icon titles. Each 
subsection has the following format: 


[Description Size | 
[Icon title string 
[No. of long integers minus 1 of data (N-1) | 2 
[Long integer data 


The long integer data values appear to describe the shape of the icon that is associated 
with the specific icon type. For example, the Stop icon has the shape of an octagon. 


5. Alert Button Phrase Section 
This section contains a list of the phrases that should appear within alert buttons. The 
first integer contains the number minus 1 of the button title strings. Each string 
always occupies 16 bytes (1 for the length byte and 15 for the title bytes) even if the 
title has less than 15 characters. 


6. Alert Phrase information Section 

This section contains a table of records each with 3 integers (6 bytes). These records 
describe the ID value, the alert stage values, and the length of the alert phrases in the 
Alert Phrase Section that is mentioned below. The first integer of this section contains 
the number of records within this section. Each record has the following format: 


[Description Ci Size | 
Palert phrese DSSS C2 
[Alert stages date (72) SCS 2 
[Alert phrase date length _——=SCS 2 


| believe the alert stages data describes the type of alert to display (e.g. Caution alert) 
and its sound stages in a manner similar to the Macintosh dialog sound alert method. 
The alert phrase data length contains the number of bytes that the phrase requires. If 
the length is negative. then the phrase is unused (in my phrase file disassemblies | mark 
negative length phrases with the phrase “<Phrase has length of zero>”). 
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7. Alert Phrase Section 

This section contains the phrases that are displayed when a tool shows an alert box to 
the user. The majority of a phrase file is occupied by this data since the majority of 
Lisa tools require a lot of phrases in order to be user—friendiy. Each phrase in this 
section contains several sequentual substrings. The total length of each phrase in bytes 
is given by the Alert Phrase information Section from above. Several special characters 
are used within the phrases for special purposes. ASCII character $FF represents a Line 
Feed (marked in the phrase listing by a “\L"). ASCII characters in the range $F0—$FE 
correspond to parameter phrases which wil! replace the ASCII occurrence when the 
phrase is displayed within an alert box. These are marked in the phrase listing by “\Fx" 
where “x" is a hexadecimal digit. 


SAMPLE PHRASE FILE RAW HEXADECIMAL DUMP 

This listing came from the Lisa Clock phrase file (“{T 13}Ptwase") from the Lisa Office 
System 3.1 (a.k.a., Lisa 7/7). All values are in hexadecimal with each 16 byte line 
followed by the ASCII equivalents. 


Hex Dump of file "{t13}phrase" 


: 0001 0001 77FF FFFF O0A6 OA46 G06C G652F [.......... File/]) 
: 5072 GQ6E 7414 5365 7420 4173 6964 6520 [Print.Set Aside | 
: 4876 6572 7974 6869 6E67 2000 2011 5968 [Everything . .Se 
: 7420 4173 6964 6520 2243 BCEF 6368 2220 [t Aside “Clock” 
: 0020 0120 2000 200F S361 7665 2026 2050 [. .- . .Save & P 
: 7574 2041 7761 7920 0020 OFS3 6176 6520 [ut Away . .Save 
: 2620 436F 6E74 GOGE 7565 2000 201A 5265 [& Continue . .Re 
: 766S 7274 2074 GF20 SOT2 6576 BO6F 7573 ue to Previous 
: 2056 6572 7369 GFEE 2000 2001 2020 0020 | Version. .- . 

: 1740 GFGE 6974 OF72 2074 6885 2050 7269 toute the Pri 
: GE74 6572 202E 2E2E 2000 2000 DCFD OCO1 [nter 


ait $i 
.. B.NANC...t 


g 
SERRESS 
ERXE 

5 


g 
o 

g 

> 

g 

g 


RoSs 
BERS 
BERSaR 


: 2020 2020 2020 
: 2020 2020 2020 


138 
a8 
8 


gEDERRSERERBRE 


ag 
EEE. 


476A 0061 0066 476A 


5 
$ 
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: 0574 6861 7420 0773 Z 

: 7070 6561 7220 0766 6572 652E 2020 0349 [ppear . here. 

: 6620 0479 6F75 2004 6172 6520 0775 6E61 [f .you . are _una 
: 6260 6520 0374 6F20 0970 726F 6965 6564 [ble . to _proceed] 
: 2C20 0863 6FGE 7461 6374 2002 6120 0A71 [. .contact .a .q] 
: 7561 6C69 6669 6564 2006 7365 7276 6963 [ualified . servic] 
: 6520 1072 6570 7265 7965 6E74 6174 6976 [e . zope coentati 


is "The .Lisa . is] 
: 2007 6861 7669 GEG? 200A 7465 6366 6EB9 "having . techni] 
: 6361 6C20 GD64 6966 6669 6375 6C74 6065 cal .difficultie 
: 7320 0A61 6963 6573 7369 GEG7 2004 7468 [s . accessing .th 
; 6520 0873 7461 7274 7570 2007 6469 7368 [e . startup . disk] 
: 2E20 2004 5075 7420 0561 7761 7920 0579 [. .Put . away .y) 
: 6F7S 7220 0A64 6F63 756D 656E 7473 2004 [our . documents . 
: 6FEE 6520 0361 7420 0261 2005 7469 6D65 [one . at .a . time 
: 2003 6F72 2005 7075 7366 2004 7466 6520 [ .or .push .the ] 
: O54C 6973 6120 O76F GE2D 6FG6 6620 0762 [.Lisa .on-off .b] 
: 7574 746F 6E20 0374 6F20 0573 6176 6520 [utton .to .save 

: 0574 6665 6020 0561 6CEC 2E20 FFFF 0349 [. thom .all. ...I 


: OB72 6563 7572 7320 2006 7265 6665 7220 [. recurs, .refer 

: 0374 GF20 0474 6865 2005 4069 7361 2007 [.to .the .Lisa. 

: 4F66 6669 6365 2007 5379 7374 656D 2006 [Office .System . 

: 6061 6E75 616C 2020 0941 7070 656E 6469 [manual. _ Appendi } 
: 7820 0341 2020 O74F 6666 6063 6520 0753 [x .A, .Office .S} 


: 6620 0474 6865 2008 7072 GFG62 6C65 6020 [f .the . -Problon | 
] 
] 


: 7973 7465 6020 0645 7272 6F72 200A 4065 [ystem .Error .He] 
: 7373 6167 6573 2020 0675 8E64 6572 2008 [ssages, . under | 
: 4469 6666 6063 756C 7479 200A 4163 6365 [Difficulty .Acce 
: 7373 BOBE 6720 0644 6973 BB2E 2004 5466 sae Disk. .Th 
: 6520 0568 6F7S 7220 0S6D 7573 7420 0362 [e .hour .must .b 
: 6520 0261 2007 6E7S 6062 6572 2006 6265 [e .a . number .be] 
: 7477 6565 6E20 2004 61G6E 6420 0432 agile 0 .and .2] 
: S32E 20FF FFO4 S466 6520 OS6C 6173 7420 .The .last ] 
: OABB 6579 7374 726F 6865 2004 7761 7320 [. ibiuue .was | 
: 0864 6973 6361 7264 6564 2E20 0454 6665 t- discarded. . The 
: 2005 686F 7572 2005 607S 7374 2003 6265 [ .hour .must .be 
: 2002 6120 O76E 756D 626S 7220 0862 6574 [ .a . number bet] 
: 7765 656E 2002 3120 0461 6EG4 2004 3132 ween .1 .and . 12) 
: 2E20 FFFF 0454 6665 2005 6C81 7374 200A [. ...The .last .] 
: 6865 7973 7472 6FGB 6520 0477 6173 2008 [keystroke .was . ] 
: 6469 7963 6172 6465 642E 2004 S468 6520 [discarded. . The 

: O760 606E 7574 6520 0560 7573 7420 0362 [. minute .must .b 
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6572 2008 6265 [¢ .4 .number . be] 

616E 6420 0495 [tween .0 .and .5 
. ... The . last 
. keystroke . was 
.discarded. . The 
.emn/om . setting 
.is .limited .t 


savestenes 


~l 


: 2008 6469 ystroke . was .di 
; 7063 GIT? B46S GAZE 2004 S408 E500 0680 scarded. .The .m 
: 6FGE 7468 2005 6075 7374 2003 6265 2002 [onth .must .be . } 
: 6120 O76E 7560 6265 7220 0862 6574 7765 [a . number _betwe] 
: 6S6E 2002 3120 0461 GE64 2004 3132 2E20 [en .1 . and . 12. 
: FFFF 0454 6865 2005 6C61 7374 200A GBES [...The .last .ke 


: 7973 7472 6FGB 6520 0477 6173 2008 6469 [ystroke .was .di] 
: 7363 6172 6465 642E 2004 S468 6520 0464 [scarded. . The .d]} 
: 6179 2005 6D75 7374 2003 6265 2002 6120 [ay .must .be .a | 
: O76E 756D 6265 7220 0662 6574 7765 SSE ie . between 
: 2002 3120 0461 GEG4A 2004 3238 2020 0432 [ .1 .and .28, .2 
: 3920 2004 3330 2020 O96F 7220 0433 312C [9 .30, .or .31.] 
: 200A 6465 7065 6E64 696E 6720 O36F 6E20 [ . depending .on } 
: 0474 6865 2007 GOGF 6E74 682E 20FF FF04 [.the .month. ... 
: 5468 6520 OS6C 6173 7420 OAGB 6579 7374 [The . last . keyst 
: 726F 6B6S 2004 7761 7320 0B64 6973 6361 ie .was .disca 
: 7264 6564 2E20 0454 6865 2005 7065 6172 [rded. .The . year 
: 2005 6075 7374 2003 6265 2002 6120 O76E [ .must .be .a .n 
: 756D 6265 7220 0862 6574 7765 6S6E 2003 [umber . between . 

: 3831 2004 616E 6420 04399 352E 20FF FFO4 [81 .and .95. ...] 
: 5468 6520 OS6C 6173 7420 OAGB 6579 7374 [The . last _keyst] 
: 726F GB6S 2004 7761 7320 0864 6973 6361 [roke .was .disca 
: 7264 6564 2E20 0454 6865 2004 5461 6220 [rded. “The . Tab 
: 0461 6E64 2006 456E 7465 7220 0568 6579 rae .Enter . key) 
: 7320 0577 606C 6C20 0861 6476 616E 6365 [s .will . advance] 
: 2004 7468 6520 0A73 656C 6563 7469 GFGE [ .the . selection 
: 2003 746F 2004 7468 6520 OS6E 6578 7420 [ .to ve nee 
: 0786 06S 6084 2E20 0454 O5e5 200A 428) |. Field, . The 

: 6368 7370 6163 6520 0468 6579 2005 7769 [ckspace . key ‘a 
: 6CBC 2005 6D6F 7665 2004 7466 6520 0A73 [11 .move .the .s] 
: 656C 6563 7469 6FGE 2003 746F 2004 7468 [election .to th] 
: 6520 0A70 7265 6965 6469 GEG7 2006 6669 [e . preceding .fi 
: 656C 642E 2020 0454 6665 2007 5265 7475 [eld. .The .Retu 
: 726E 2004 6B6S 7920 0577 696C 6C20 0560 ie -key .will .m] 
: 6F76 6520 0474 6865 200A 7365 6C65 6374 [ove .the . select ] 
: ion .to .the .ho 
: 6520 OS6C 6173 7420 OAGB 6579 7374 726F [e .last .keystro] 


Address 0 2 


000600: 6865 2004 7761 7320 0864 6973 6961 7264 [ke .was . discard] 
000810: 6564 2E20 0454 6865 2006 496C G6F63 6820 [ed. .The .Clock ] 
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: 0663 6F75 6064 2004 GEGF 7420 0962 6520 {. could .not .be J 
: 0473 6874 2003 6173 2004 796F 7520 0872 [.set .as .you . mA 
: 6571 7565 7374 6564 2E20 OC2F 3A2F 2F61 [equested. ./://a 
: 602F 7080 2F31 3205 6064 7930 2F29 3120 wpm 12.0), 
: 200A 6465 7065 GE64 GOGE 6720 O36F 6E20 { . depending . on 
: 0474 6865 2007 GOGF 6E74 682E 20FF FFO4 [.the .month. ...] 
: 5468 6520 OS6C 
: 726F 6B6S 

: 7264 6564 

: 2005 6075 737 
: 7S6D 6265 

: 3831 2004 

: 5468 6520 

: 726F 6865 

: 7264 6564 


a 


79 7374 [The . last -kayst] 
ae .was .disca 


a 
a 
at 


BREE 


The . last -keyst 
eke .was .disca 
rded. .The . Tab 
and .Enter .key 
s .will . advance 
.the . selection 
.to .the . next 
-field. .The .Ba 
ckspace .key .wi 
ll .move .the .s 
election .to .th 
e . preceding at 
eld. .The .Retu 
6020 0560 [rn .key .will .a] 
6065 6374 [ove .the . select } 
2005 686F [ion .to .the . es 
FFO4 S468 [ur .field. .. 
7374 726F [e . last Sreieal 


a8 
BREESE SEREERSSERUSRE 
ZERRRS 
SNURERSE REE 


Ba3 


a8 


nd 
a 
an 


8 


suReRenaa2a2 
TELE 


3 
E 
g 


SSBSEERR SRS 
tbat ebb hdd 


BRE 


000900: 
0009E0: 
O00SF 0: 


3 
& 


Finis 


SAMPLE PHRASE FILE DISASSEMBLY 

This listing came from the Lisa Clock phrase file (“{T13}Phrase") from the Lisa Office 
System 3.1 (a.k.a. Lisa 7/7). This phrase file is in the New format and contains a Menu 
Phrase Section. The Alert Phrase information Section was read using my PhraseDisasm 
program and made more readable as a table that includes the starting address of each 
phrase. Notice the phrases with Length equal to 0. These originally had negative lengths 
which | interpreted as meaning the phrase was unused. 


string info table base address = $000001C8 
str_count = 15 
StrID Kind Length Address 


18282/$476A 
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18282/$476A 1561/$000006 19 


270 
54 
13 

6 


The real phrase file disassembly follows: 
; Phrase File °“{t13}phrase“ 


; ‘ee Henu phrases HH 
: Menu count = 1 


MENU #1 <011900999999999199999199199999711> 
File/Print 

Set Aside Everything 

Set Aside “Clock” 


Save & Put Away 
Save & Continue 
Revert to Previous Version 


Honitor the Printer ... 

; ‘Hee Alert Icon phrases H+ 

; "2" icon phrase 

? 

; Icon words: 44 66 10 66 44 117 78 66 44 15 

3; "WAIT" icon phrase 

Wait 

: Icon words: 25 66 78 65 78 67 12 116 11 116 10 115 10 17 11 16 12 16 
: “STOP" icon phrase 

St 


op 

; Icon words: 44 66 10 67 30 117 56 117 78 87 78 4S SB 15 30 15 10 45 
; “NOTE icon phrase 

Note 

: Icon words: 44 66 20 30 20 102 68 102 68 30 

; “CAUTION” icon phrase 

Caution 

: Icon words: 68 66 7 6S 7 67 79 121 80 121 81 120 81 12 80 11 79 11 


; eH Alert Button phrases HHH 
: # button phrases = 2 


Cancel 
OK 


; eee File Strings H+ 
; string count = 15 


PHRASE # 1 <Kind $5F00> 
The Clock could not find the message that should appear here. If you are 
unable to proceed, contact a qualified service representative, and mention 
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the number \FC. 


PHRASE # 2 <Kind $4F005 

The Lisa is having technical difficulties accessing the startup disk. 

Put away your documents one at a4 time or push the Lisa on-off button to 
save them all. \L\LIf the problem recurs, refer to the Lisa Office System 
manual, Appendix A. Office System Error Messages, under Difficulty Accessing 
Disk. 


PHRASE #3 <Kind $4F00> 
<Phrase has length of zero> 


PHRASE # 4 <Kind $3F00> 
<Phrase has length of zero> 


PHRASE # 99 <Kind $476A> 
The hour must be a number between 0 and 23. \L\LThe last keystroke was 
discarded. 


PHRASE # 100 <Kind $476A> 
The hour must be a number between 1 and 12. \L\LThe last keystroke was 
discarded. 


PHRASE # 101 <Kind $476A> 
The minute must be a number between 0 and 50. \L\LThe last keystroke was 
discarded. 


PHRASE # 102 <Kind $476A> 
The am/pm setting is limited to am and pm. \L\LThe last keystroke was discarded. 


PHRASE # 103 <Kind $476A> 
The month must be a number between 7 and 12. \L\LThe last keystroke was 
discarded. 


PHRASE # 104 <Kind $476A> 
The day must be a number between 1 and 26. 29, 30. or 31, depending on 
the month. \L\LThe last keystroke was discarded. 


PHRASE # 105 <Kind $476A> 
The year must be a number between 61 and 95. \L\LThe last keystroke was 
discarded. 


PHRASE # 106 <Kind $476A> 

The Tab and Enter keys will advance the selection to the next field. The 
Backspace key will move the selection to the preceding field. The Return 
key will move the selection to the hour field. \L\LThe last keystroke was 
discarded. 


PHRASE # 107 <Kind $4F00> 
The Clock could not be set as you requested. 


PHRASE # 109 <Kind $0000> 
ff fan/pa/ 12 
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PHRASE # 110 <Kind $0000) 
mdy0/ 


;F INI s 

SUMMARY 

This document has presented the results of my analysis of the internal structure of 
phrase files for the Apple Lisa computer. Most of the structure is known completely, 


but small portions are still amystery. As time progresses | will attempt to rectify this 
lapse and this document will be made more complete. 


«<< Finis >>> 
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